home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
IRIX Base Documentation 1998 November
/
IRIX 6.5.2 Base Documentation November 1998.img
/
usr
/
share
/
catman
/
u_man
/
cat1
/
xwsh.z
/
xwsh
Wrap
Text File
|
1998-10-20
|
94KB
|
1,717 lines
XXXXWWWWSSSSHHHH((((1111GGGG)))) XXXXWWWWSSSSHHHH((((1111GGGG))))
NNNNAAAAMMMMEEEE
xwsh - creates and specifies a window shell
SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
xxxxwwwwsssshhhh [ ----aaaannnncccchhhhoooorrrr anchor-point ] [ ----aaaauuuuttttooooffffoooorrrrkkkk ] [ ----bbbbgggg color ]
[ ----bbbbiiiinnnnddddkkkkeeeeyyyy2222ddddccccssss ] [ ----bbbboooolllldddd color ] [ ----bbbboooollllddddffffoooonnnntttt font ]
[ ----bbbboooollllddddiiiittttaaaalllliiiiccccffffoooonnnntttt font ] [ ----cccccccc string ] [ ----ccccoooonnnnssssoooolllleeee ]
[ ----ccccuuuurrrrssssoooorrrrbbbbgggg color ] [ ----ccccuuuurrrrssssoooorrrrffffgggg color ] [ ----ddddiiiissssppppllllaaaayyyy display ]
[ ----eeee cmd [ args ] ] [ ----ffffgggg color ] [ ----ffffnnnn font ] [ ----ggggeeeeoooommmm geometry-
string ] [ ----hhhheeeellllpppp ] [ ----hhhhiiiigggghhhhlllliiiigggghhhhttttUUUURRRRLLLL ] [ ----hhhhoooolllldddd ] [ ----hhhhoooollllddddoooonnnneeeerrrrrrrroooorrrr ]
[ ----iiiibbbbmmmm ] [ ----iiiiccccoooonnnniiiicccc ] [ ----iiiiccccoooonnnnttttiiiittttlllleeee icon-title ] [ ----iiiittttaaaalllliiiiccccffffoooonnnntttt font ]
[ ----kkkkeeeeyyyymmmmaaaapppp file ] [ ----lllloooogggg file ] [ ----mmmmaaaaxxxx COLSxxxxLINES ]
[ ----mmmmiiiinnnn COLSxxxxLINES ] [ ----nnnnaaaammmmeeee instance-name ] [ ----nnnnoooobbbbiiiinnnnddddkkkkeeeeyyyy2222ddddccccssss ]
[ ----nnnnooookkkkeeeeyyyybbbbooooaaaarrrrdddd ] [ ----nnnnoooommmmeeeennnnuuuu ] [ ----nnnnoooossssccccrrrroooollllllllbbbbaaaarrrr ] [ ----nnnnoooosssseeeennnndddd ]
[ ----rrrreeeeddddiiiirrrreeeecccctttt device ] [ ----sssseeeellllbbbbgggg color ] [ ----sssseeeellllffffgggg color ]
[ ----ssssllll retainlimit ] [ ----ttttiiiittttlllleeee title ] [ ----ttttrrrraaaannnnssssiiiieeeennnntttt window ] [ ----uuuutttt ]
[ ----vvvvbbbb ] [ ----vvvvtttt111100000000 ] [ ----xxxxrrrrmmmm resource-string ]
DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
_x_w_s_h is a terminal emulation program that runs a login shell (or other
UNIX command) within its own window on the screen.
Command line options are available to specify the font, window size,
title, and position when _x_w_s_h starts up. The command line options are:
----aaaannnncccchhhhoooorrrr _a_n_c_h_o_r-_p_o_i_n_t
Set the anchor point for window size changes. When the window
size is changed from the size menu, xwsh needs to define which
corner of the window is anchored down during the size change.
xwsh attempts to keep the anchor point constant across the size
change. Legal values are nnnnoooorrrrtttthhhhwwwweeeesssstttt, nnnnoooorrrrtttthhhh, nnnnoooorrrrtttthhhheeeeaaaasssstttt, eeeeaaaasssstttt,
ssssoooouuuutttthhhheeeeaaaasssstttt, ssssoooouuuutttthhhh, ssssoooouuuutttthhhhwwwweeeesssstttt, wwwweeeesssstttt, cccceeeennnntttteeeerrrr, and ssssttttaaaattttiiiicccc.
----aaaauuuuttttooooffffoooorrrrkkkk
Make _x_w_s_h run in the background.
----bbbbgggg _c_o_l_o_r
Set the background (page) color.
----bbbbiiiinnnnddddkkkkeeeeyyyy2222ddddccccssss
Enable key bindings to device control strings and internal xwsh
functions. Unless explicitly enabled, xwsh will no longer bind
keys to control strings (see DCS codes 101 and 103 below).
----bbbboooolllldddd _c_o_l_o_r
Set the bold text color. This color is used when ansi SGR bold
is done.
----bbbboooollllddddffffoooonnnntttt _f_o_n_t
Define the bold font. The bold font is used when the ansi SGR
bold is done. Note that both a color and a font can be chosen
and that both will apply.
PPPPaaaaggggeeee 1111
XXXXWWWWSSSSHHHH((((1111GGGG)))) XXXXWWWWSSSSHHHH((((1111GGGG))))
----bbbboooollllddddiiiittttaaaalllliiiiccccffffoooonnnntttt _f_o_n_t
Define the bold italic font. When both ansi SGR bold and ansi
SGR italic are done this font is used.
----cccccccc _s_t_r_i_n_g
Change the character class table using _s_t_r_i_n_g. _S_t_r_i_n_g is
composed of zero or more comma separated "range:value"
substrings. _r_a_n_g_e can be either a single number or a pair of "-"
separated numbers. When a single number is specified a single
characters class is set to the _v_a_l_u_e. When a _r_a_n_g_e is specified,
all the characters inclusively in the range are have their class
set to _v_a_l_u_e. The character class is used by the double click
logic to determine what is similar and what is different.
Characters that share the same character class are considered
similar. The initial character class table contains the
following values:
32, 1, 1, 1, 1, 1, 1, 1,
1, 32, 1, 1, 1, 1, 1, 1,
1, 1, 1, 1, 1, 1, 1, 1,
1, 1, 1, 1, 1, 1, 1, 1,
32, 33, 34, 35, 36, 37, 38, 39,
40, 41, 42, 43, 44, 45, 46, 47,
48, 48, 48, 48, 48, 48, 48, 48,
48, 48, 58, 59, 60, 61, 62, 63,
64, 48, 48, 48, 48, 48, 48, 48,
48, 48, 48, 48, 48, 48, 48, 48,
48, 48, 48, 48, 48, 48, 48, 48,
48, 48, 48, 91, 92, 93, 94, 48,
96, 48, 48, 48, 48, 48, 48, 48,
48, 48, 48, 48, 48, 48, 48, 48,
48, 48, 48, 48, 48, 48, 48, 48,
48, 48, 48, 123, 124, 125, 126, 1,
128, 129, 130, 131, 132, 133, 134, 135,
136, 137, 138, 139, 140, 141, 142, 143,
144, 145, 146, 147, 148, 149, 150, 151,
152, 153, 154, 155, 156, 157, 158, 159,
160, 161, 162, 163, 164, 165, 166, 167,
168, 169, 170, 171, 172, 173, 174, 175,
176, 177, 178, 179, 180, 181, 182, 183,
184, 185, 186, 187, 188, 189, 190, 191,
48, 48, 48, 48, 48, 48, 48, 48,
48, 48, 48, 48, 48, 48, 48, 48,
48, 48, 48, 48, 48, 48, 48, 48,
48, 48, 48, 48, 48, 48, 48, 223,
48, 48, 48, 48, 48, 48, 48, 48,
48, 48, 48, 48, 48, 48, 48, 48,
48, 48, 48, 48, 48, 48, 48, 247,
248, 48, 48, 48, 48, 48, 48, 48
PPPPaaaaggggeeee 2222
XXXXWWWWSSSSHHHH((((1111GGGG)))) XXXXWWWWSSSSHHHH((((1111GGGG))))
----ccccoooonnnnssssoooolllleeee
Make this xwsh the console. All this does is issue the TIOCCONS
ioctl in the child process on the pty. If it succeeds then the
xwsh will manage console output and input. If it fails, a
warning will appear in the first line of the xwsh.
----ccccuuuurrrrssssoooorrrrbbbbgggg _c_o_l_o_r
Set the cursor background color.
----ccccuuuurrrrssssoooorrrrffffgggg _c_o_l_o_r
Set the cursor foreground color. This the color that the
character under the cursor (if any) will be rendered in.
----ddddiiiissssppppllllaaaayyyy _d_i_s_p_l_a_y
Define which display xwsh will display to.
----eeee _c_m_d [_a_r_g_s]
Execute a child program within the _x_w_s_h window, using the
specified command line arguments, rather than the default login
shell (determined from the password database). The ----eeee option
will pass all trailing arguments to _x_w_s_h , to be executed as a
command line. Thus, if ----eeee is given, it must appear as the final
_x_w_s_h option. In order to determine what state the tty should
have _x_w_s_h will examine the file $_H_O_M_E/._w_s_h_t_t_y_m_o_d_e. This file
should be created using the output of _s_t_t_y -_g. If the file
doesn't exist, or if the file contains improper information, _x_w_s_h
will use the system defaults for the tty state.
----ffffgggg _c_o_l_o_r
Set the foreground (text) color.
----ffffnnnn _f_o_n_t
Set the primary rendition font. Note that different fonts can be
used for bold, italic and bold-italic renditions. See ansi SGR
below in the section on escape sequences. If a proportional
width font is chosen xwsh will still function as a terminal
emulator. The characters will be positioned based on their
natural widths, but the right margin will remain at the number of
columns being emulated (usually 80). This means that a line may
wrap _b_e_f_o_r_e or _a_f_t_e_r the right edge of the window is reached.
----ggggeeeeoooommmmeeeettttrrrryyyy _g_e_o_m_e_t_r_y-_s_t_r_i_n_g
This option provides xwsh with an X compatible geometry
specification. If the geometry-string includes x and y
coordinates, then xwsh will automatically set the anchor point
(see the -anchor option for more information). This option will
not be propagated via a _c_l_o_n_e.
----hhhheeeellllpppp Print out a concise description of the command line options to
xwsh.
PPPPaaaaggggeeee 3333
XXXXWWWWSSSSHHHH((((1111GGGG)))) XXXXWWWWSSSSHHHH((((1111GGGG))))
----hhhhoooolllldddd Hold _x_w_s_h after its child program has exited, to permit viewing
its output. See ----hhhhoooollllddddoooonnnneeeerrrrrrrroooorrrr for a more useful variation.
Keyboard input is no longer accepted once the child process that
xwsh is managing exits.
----hhhhiiiigggghhhhlllliiiigggghhhhttttUUUURRRRLLLL
Cause _x_w_s_h to highlight any URLs it detects in the stream of text
that it prints. See below for more details about XWsh and URLs.
This option is off by default.
----hhhhoooollllddddoooonnnneeeerrrrrrrroooorrrr
Inform _x_w_s_h that it should hold the display when the command
exits, if and only if the command exits with an error. Keyboard
input is no longer accepted once the child process that xwsh is
managing exits.
----iiiibbbbmmmm Tell xwsh to use rebind the keyboard to look as much like an IBM
rt keyboard as possible. This is the default mode.
----iiiiccccoooonnnniiiicccc Start up _x_w_s_h in an iconic form.
----iiiiccccoooonnnnttttiiiittttlllleeee _s_t_r_i_n_g
Define the icon title for the xwsh window. The icon title can be
set separately from the window title using this option.
----iiiittttaaaalllliiiiccccffffoooonnnntttt _f_o_n_t
Define the italic font. The italic font is used when the ansi
SGR italic is done.
----kkkkeeeeyyyymmmmaaaapppp _f_i_l_e
Define a key map file for the xwsh window. See the section below
on key maps.
----lllloooogggg _f_i_l_e
Have _x_w_s_h log the output of the child program into _f_i_l_e.
----mmmmaaaaxxxx _C_O_L_Sxxxx_L_I_N_E_S
Set the maximum window size, as the number of columns wide by the
number of lines high. There is no default maximum window size.
Note that the xxxx is literal. For example, 88880000xxxx44440000 would limit xwsh
to a maximum of 80 columns and 40 rows.
----mmmmiiiinnnn _C_O_L_Sxxxx_L_I_N_E_S
Set the minimum window size, as the number of columns wide by the
number of lines high. There is no default minimum window size.
Note that the xxxx is literal. For example, 88880000xxxx11110000 would limit xwsh
to a minimum of 80 columns and 10 rows.
----nnnnaaaammmmeeee _i_n_s_t_a_n_c_e-_n_a_m_e
Provide a unique name for an _x_w_s_h window. This name becomes the
instance name of the specific xwsh, with the class name always
being "XWsh".
PPPPaaaaggggeeee 4444
XXXXWWWWSSSSHHHH((((1111GGGG)))) XXXXWWWWSSSSHHHH((((1111GGGG))))
----nnnnoooobbbbiiiinnnnddddkkkkeeeeyyyy2222ddddccccssss
Disallow binding of keys to device control strings (see DCS codes
101 and 103 below).
----nnnnooookkkkeeeeyyyybbbbooooaaaarrrrdddd
Run _x_w_s_h without a keyboard. Any data received from the main
keyboard is ignored. Use this when you need an output only _x_w_s_h.
----nnnnoooommmmeeeennnnuuuu Disable the menu. No menu will appear, thus disabling font and
size changes for xwsh.
----nnnnoooossssccccrrrroooollllllllbbbbaaaarrrr
Disable the scroll bar in xwsh. No scroll bar will be made
visible, though more than a windows full of data may be retained
with the ----ssssllll option. By using local key bindings the data may
still be viewed.
----nnnnoooosssseeeennnndddd Disable the middle-pointer _s_e_n_d feature.
----rrrreeeeddddiiiirrrreeeecccctttt _d_e_v_i_c_e
Provide an alternate (redirect) output device. When _x_w_s_h
receives a "toggle-redirect" command from a locally bound
function key, the output of the _x_w_s_h is redirected to the given
device.
----sssseeeellllbbbbgggg _c_o_l_o_r
Set the selection background (page) color.
----sssseeeellllffffgggg _c_o_l_o_r
Set the selection foreground color. This the color that
characters in the selection will be rendered in.
----ssssllll _r_e_t_a_i_n_l_i_m_i_t
set the number of _l_i_n_e_s of text retained by _x_w_s_h. Using the
scroll bar one can view all of the lines retained by _x_w_s_h. New
lines entered by _x_w_s_h are retained up to the limit specified by
_l_i_n_e_s; after this, lines are deleted from the ``top'' of the list
of lines. Setting _l_i_n_e_s to zero eliminates the scroll bar. The
default value is 1000.
----ttttiiiittttlllleeee _t_i_t_l_e
Set the title of the window to _t_i_t_l_e.
----ttttrrrraaaannnnssssiiiieeeennnntttt _w_i_n_d_o_w
Make xwsh a transient for window. If window is "root" then xwsh
becomes a transient for the root window on the given display.
----uuuutttt Tell xwsh not to write records into the system log files
////eeeettttcccc////uuuuttttmmmmpppp and ////eeeettttcccc////wwwwttttmmmmpppp....
PPPPaaaaggggeeee 5555
XXXXWWWWSSSSHHHH((((1111GGGG)))) XXXXWWWWSSSSHHHH((((1111GGGG))))
----vvvvbbbb Tell xwsh to use a visual bell whenever it receives octal 7. The
default behavior is to ask X to ring the bell.
----vvvvtttt111100000000 Make xwsh run as a vt100 terminal emulator. Normally, xwsh
emulates the "iris-ansi" terminal, which is almost a vt100. This
switch makes a few minor changes to the emulation for a majority
of vt100 compatibility. Most everything is supported, with the
exception of double width and double height characters. The -fn,
-boldfont, -italicfont and -bolditalicfont options (and
resources) are ignored when -vt100 mode is enabled. To change
the particular font use the ddddeeeeccccAAAAsssscccciiiiiiiiFFFFoooonnnntttt and ddddeeeeccccGGGGrrrraaaapppphhhhiiiiccccssssFFFFoooonnnntttt
resources (see -xrm, below).
When in alternate key pad mode (ESC =), the special function keys
F9-F12 on the IRIS keyboard emulate the keys PF1-PF4 on a VT100
keyboard. (ESC P, ESC Q, ESC R, ESC S).
----xxxxrrrrmmmm _r_e_s_o_u_r_c_e-_s_t_r_i_n_g
Define a resource value in the command line. See the resource
section below for a list of xwsh's available resources.
When you log on to a remote system, use vt100 if no iris-ansi entry
exists in the terminfo or termcap file. You probably need to set the
_x_w_s_h terminal size to 80,24 and run xwsh with the -vt100 option for this
to work properly.
When you use _v_i, _e_m_a_c_s, or other visual-mode programs remotely, you must
size the terminal window to match the terminal size referenced by the
current $TERM environment variable. Some systems (including IRIX)
support the ability to query the terminal size, and if this is the case,
xwsh should work correctly regardless of its size.
When in alternate key pad mode (ESC =), the special function keys F9-F12
on the IRIS keyboard emulate the keys PF1-PF4 on a VT100 keyboard. (ESC
P, ESC Q, ESC R, ESC S).
KKKKEEEEYYYY BBBBIIIINNNNDDDDIIIINNNNGGGG
_x_w_s_h supports limited key binding through the _b_i_n_d_k_e_y(1) command. See
the _b_i_n_d_k_e_y man page for details.
KKKKEEEEYYYY MMMMAAAAPPPPPPPPIIIINNNNGGGG
To provide for highly customized keyboard xwsh supports key mapping. Key
mapping provides a two tier mapping system. At the bottom level is the
keysym rebinding supported by Xlib (see _X_R_e_b_i_n_d_K_e_y_s_y_m(3X) for details).
The top level bindings are independent of the Xlib bindings, but take
precedence over them. The keyboard input translation first checks the
input keysym (as returned by _X_L_o_o_k_u_p_S_t_r_i_n_g(3X)) against the top level
bindings. If a binding for the keysym exists and the modifiers match or
are ignored (by using the aaaannnnyyyy modifier) then the top level binding is
used. The top level binding will either generate a string whose output
is sent to the underlying shell or the binding will invoke a function
internal to xwsh. If no top level binding exists then the string
PPPPaaaaggggeeee 6666
XXXXWWWWSSSSHHHH((((1111GGGG)))) XXXXWWWWSSSSHHHH((((1111GGGG))))
returned from _X_L_o_o_k_u_p_S_t_r_i_n_g(3X) is used.
When the keyboard is in IBM rt mode three modifications to the above
process are done. First, at start up the keyboard is rebound using
_X_R_e_b_i_n_d_K_e_y_s_y_m to closely match the IBM rt definitions (this is what
previous IRIX releases used). Second, when a key press occurs the
modifier state is prioritized such that no chording of modifiers is
allowed (Alt is highest priority, Control is next, Shift is lowest).
Finally, if the decoded keysym has no top level binding and its the PPPPaaaauuuusssseeee
key and the user has pressed the CCCCoooonnnnttttrrrroooollll modifier then a break function
is performed on the tty.
Here is the syntax for the key mappings:
_k_e_y_s_y_m(_m_o_d_i_f_i_e_r_s): sssseeeennnndddd(_s_t_r_i_n_g);
_k_e_y_s_y_m(_m_o_d_i_f_i_e_r_s): ffffuuuunnnncccc(_s_t_r_i_n_g);
_k_e_y_s_y_m(_m_o_d_i_f_i_e_r_s): rrrreeeebbbbiiiinnnndddd(_s_t_r_i_n_g);
_k_e_y_s_y_m(_m_o_d_i_f_i_e_r_s): uuuunnnnbbbbiiiinnnndddd();
_k_e_y_s_y_m is a standard keysym as defined by X. _m_o_d_i_f_i_e_r_s can be one or
more of the standard modifiers (SSSShhhhiiiifffftttt, CCCCoooonnnnttttrrrroooollll, AAAAlllltttt) or aaaannnnyyyy. If any is
used then the modifier state is unimportant during input checking.
_s_t_r_i_n_g can contain C style backslash sequences, such as \n, in order to
embed control characters.
If the target for the mapping is sssseeeennnndddd then the given _s_t_r_i_n_g will be sent
when the key (with its modifiers) is pressed. This mapping applies to
the top level bindings.
If the target for the mapping is ffffuuuunnnncccc then the given _s_t_r_i_n_g will be used
to apply an internal function to xwsh. The following internal functions
are currently supported: send, up-line, down-line, up-page, down-page,
home, end, push, pop and toggle-redirect.
If the target for the mapping is rrrreeeebbbbiiiinnnndddd then the given _s_t_r_i_n_g will be
sent when the key (with its modifiers) is pressed. This mapping applies
to the bottom level bindings and just invokes an XXXXRRRReeeebbbbiiiinnnnddddKKKKeeeeyyyyssssyyyymmmm when the
key mapping is applied.
If the target for the mapping is uuuunnnnbbbbiiiinnnndddd then when the key map is applied
any top level binding for the key (with its modifiers) is removed. Using
send and unbind one can setup bindings that are temporarily ``pushed''
and ``popped''.
Key mappings are specified in one of two ways. A command like option
exists which defines a key map file whose contents are lines in the
format described above. Resources also exist to define particular key
maps. See the section on string resources for more information. A quick
examination of ////uuuussssrrrr////lllliiiibbbb////XXXX11111111////aaaapppppppp----ddddeeeeffffaaaauuuullllttttssss////XXXXWWWWsssshhhh may also help.
PPPPaaaaggggeeee 7777
XXXXWWWWSSSSHHHH((((1111GGGG)))) XXXXWWWWSSSSHHHH((((1111GGGG))))
MENU OPERATION
xwsh has a popup menu which will be activated when the right pointer
button is pressed over the text area. PPPPoooopppp is used to raise the window to
the top of the window hierarchy, subject to any window manager
constraints. SSSSeeeennnndddd is used to send the primary selection (XA_PRIMARY in
ICCC terms) to the tty as if the user had typed it in. SSSSiiiizzzzeeee is a roll
off menu item that allows the user to resize the xwsh window to specific
commonly used sizes. Note that resizing a window is subject to window
manager constraints. The FFFFoooonnnntttt menu item will bring up a font browser
dialog (see below on how to use it). Finally, CCCClllloooonnnneeee is a roll off menu
item that is used to make a visually identical (within certain limits)
copy of the xwsh. The copy will have a new command, new tty, etc. It
will attempt to have the same font, same colors and other attributes.
FFFFOOOONNNNTTTT BBBBRRRROOOOWWWWSSSSEEEERRRR
The font browser is used to pick a new font for use as xwsh's primary
rendition font (there is currently no way to pick other rendition fonts).
The font browser displays three scrolling lists: the _f_o_n_t list, the _s_t_y_l_e
list and the _s_i_z_e list. The _f_o_n_t list lists in alphabetical order the
various fonts. A names shown are composed of the foundry, family,
registry and encoding (fonts that are iso8859-1 do not show the registry
and encoding). For example, _t_e_r_m_i_n_a_l (_b_i_t_s_t_r_e_a_m) is an iso8859-1 font
from _b_i_t_s_t_r_e_a_m whose family is _t_e_r_m_i_n_a_l. Also, _t_e_r_m_i_n_a_l (_b_i_t_s_t_r_e_a_m, _d_e_c,
_d_e_c_t_e_c_h) is another _t_e_r_m_i_n_a_l font from _b_i_t_s_t_r_e_a_m, but it is not an
iso8859-1 font, rather it is of the Idec _r_e_g_i_s_t_r_y _a_n_d _d_e_c_t_e_c_h _e_n_c_o_d_i_n_g.
The _s_t_y_l_e list shows names (alphabetically sorted) which are composed of
the weight, slant, slant width, and adstyle. The _s_i_z_e list shows the
available sizes for the given fonts (numerically sorted).
Any time a selection is made in one or more of the lists, items which are
not possible given the choices made are grayed out. Selections are made
by clicking on a particular item in the list. Selections can be unmade
by clicking on a selected item again. For instance, not all fonts have
15 pixel sizes. In this case when a font is chosen that has no 15 pixel
size, the 15 entry in the size list will be grayed out. The same kind of
constraints are applied to the style and font list.
There are two control buttons that determine which fonts are shown and
how they are presented. The SSSShhhhoooowwww pppprrrrooooppppoooorrrrttttiiiioooonnnnaaaallll wwwwiiiiddddtttthhhh ffffoooonnnnttttssss button when
enabled will add in proportional width fonts to the font, style and size
lists. By default this is disabled, because proportional width fonts are
often confusing to the user (see the discussion above, where -fn is
described). The SSSShhhhoooowwww ssssiiiizzzzeeee iiiinnnn ppppooooiiiinnnnttttssss button when enabled changes the
units in the size list from pixels to points. The values used for the
points to pixel scaling are computed by using information provided by the
display that xwsh is connected to.
After all three lists have an item selected, the font browser will
display a sample from the font below the SSSShhhhoooowwww ssssiiiizzzzeeee iiiinnnn ppppooooiiiinnnnttttssss button as
well as the full X name of the font in the name field editor. Using this
sample the user can preview the font choice, and if it is not desirable,
PPPPaaaaggggeeee 8888
XXXXWWWWSSSSHHHH((((1111GGGG)))) XXXXWWWWSSSSHHHH((((1111GGGG))))
keep browsing other fonts. Once a choice has been made the user can
accept it by pressing the _A_c_c_e_p_t button which changes the primary
rendition font of xwsh and dismisses the font browser. Pressing the
_A_p_p_l_y button changes the font but leaves the browser up in case another
change is desired. The _C_a_n_c_e_l button dismisses the browser with no
further font changes (it will not undo a _A_p_p_l_y).
UUUURRRRLLLLssss
xwsh optionally supports highlighting URLs that it detects in the stream
of output text. Having URLs highlighted makes them much easier to notice
when reading through lots of text. This feature is particularly useful
when coupled with the ability to pass URLs directly to a web browser
(more on this below). The disadvantage to this feature is that there is
a slight performance penalty in detecting the URLs and thus text will
print slower. Generally this is not noticeable. Also, the code that
detects URLs can be fooled under some (rare) circumstances. For more
information on passing URLs directly from xwsh to a Web browser, see the
section on Selections (below).
You can enable this behavior with the -highlightURL command line switch
or the boolean highlightURL X resource. By default this option is off.
SSSSEEEELLLLEEEECCCCTTTTIIIIOOOONNNNSSSS
xwsh supports manipulation of the primary selection (XA_PRIMARY in ICCC).
The left pointer button is the select button. The middle pointer button
is a shortcut for the _S_e_n_d menu entry (this can be disabled with the
-nosend command line option or the noQuickSend resource). Pressing left
pointer will begin a new selection. As the pointer is moved the
selection will be swept out. Finally, when the left pointer is released
a selection is made. If the area swept out is not empty then xwsh will
assert ownership of the primary selection. If xwsh cannot get ownership
of the primary selection then the selection will immediately disappear
from the display.
By rapidly clicking the left pointer button twice (down, up, down) the
user will enter double click mode. In double click mode moving the
pointer will select _w_o_r_d_s. What constitutes a word is determined by the
charClass resource. By rapidly clicking the left pointer button three
times (down, up, down, up, down) the user will enter triple click mode.
In triple click mode entire lines are selected as the pointer is moved.
Holding down the Control key while pressing the left mouse button will
select URLs. That is, if the mouse is over a piece of text that is a
URL, it is automatically selected. Releasing the mouse button while the
control key is depressed runs an external program on the currently
selected text. You can specify the program to be run through X resources
(see below). The default program that runs will start a web browser with
the selected URL.
Selections can be extended by shift-clicking the left pointer button. If
a shift-click occurs above the current selection then the selection will
be extended up to the new position. If a shift-click occurs below the
PPPPaaaaggggeeee 9999
XXXXWWWWSSSSHHHH((((1111GGGG)))) XXXXWWWWSSSSHHHH((((1111GGGG))))
current selection then the selection will be extended down to the new
position. If a shift-click occurs inside the selection then the top of
the selection remains fixed while the bottom is moved up to the new
position. Note that selections can be extended in single, double or
triple click mode.
If during the process of making a selection the pointer moves vertically
out of the text area then the text area will be automatically scrolled to
allow selections that are larger than the visible area.
Through X resources you can also use the Modifier keys (Control, Alt, and
Shift) to modify behavior of left mouse-button events. You can apply any
combination of Control, Alt, and Shift to the three actions of the left
mouse button (button down, drag with button down, and button up).
(However, specifying an action associated with the Alt and left-mouse
might interfere with a default 4Dwm binding.) The action taken when a
given key and mouse combination event occurs is specified in a way
similar to keysym functions.
The first mapping, selectDownMap, is the action taken when the left mouse
button is pressed down. The next mapping, selectDragMap, is the action
taken when the mouse is dragged (with the left button still depressed).
The final mapping, selectUpMap, is the action taken when the left mouse
button is released.
The actions available are:
BeginSelect - begin selecting a region of text
BeginExtendSelect - extend the current selection
NormalDragSelect - drag select a region of text
DoNothing - empty place holder operation
SelectURL - select an entire URL
DoFilter1 - execute filter command 1 on selection
DoFilter2 - execute filter command 2 on selection
DoFilter3 - execute filter command 3 on selection
You specify the commands executed by the 3 DoFilter actions with X
resources. The resource names are filterCmd1, filterCmd2, and filterCmd3.
The strings values of these resources are taken as a command line and
executed. If there is a "%s" (no quotes) in the string, it is replaced
with the currently selected text.
The default values for the three filter commands are:
XWsh*FilterCmd1: nr %s
XWsh*FilterCmd2: jot %s
XWsh*FilterCmd3: echo %s
It is important to note that these commands are run in the environment
that xwsh is run in by xdm. This is not the same as the environment of
the command that runs inside of the xwsh and thus environment variables
set in your shell may not be set for the filter program.
PPPPaaaaggggeeee 11110000
XXXXWWWWSSSSHHHH((((1111GGGG)))) XXXXWWWWSSSSHHHH((((1111GGGG))))
The default mapping of key and mouse clicks is as follows (taken from the
X resource file):
XWsh*selectDownMap: \
Control: func("SelectURL"); \
Shift: func("BeginExtendSelect");
XWsh*selectDragMap: \
Control: func("DoNothing"); \
Shift: func("NormalDragSelect");
XWsh*selectUpMap: \
Control: func("DoFilter1");
The mappings need not be single key modifiers, you can also specify
modifiers such as Control+Shift or Alt+Control. There can only be a
single function per key modifier however.
Note that you can select text without pressing any modifier keys, then
depress a modifier key before releasing the mouse button. Then (assuming
the modifier is still pressed) when you release the mouse button, the
selectUpMap for that modifier key will be executed.
SSSSCCCCRRRROOOOLLLLLLLL BBBBAAAARRRR OOOOPPPPEEEERRRRAAAATTTTIIIIOOOONNNN
The scroll bar is composed of four components. An up arrow, a down
arrow, a thumb and a divot. The up arrow scrolls the text display down
one line while the down arrow scrolls the text display up one line.
Dragging the thumb up will scroll the display down while dragging the
thumb down will scroll the display up. Most manipulation of the scroll
bar is done using the left pointer button. The divot is not manipulated
by the user but is used to show where the thumb was before scrolling
began (only when dragging the thumb).
By clicking the left pointer button above or below the thumb, the thumb
will begin scrolling in page sized increments until it reaches either of
the end points. By clicking the middle pointer button above, below, or
on the thumb the thumb will be moved to the location of the pointer (i.e.
a "goto" operation). The thumb will continue to track the pointer
location until the middle pointer button is released.
If the display is locked (via the Lock display escape sequence, see xwsh
set mode) or if there is insufficient data to scroll then the scroll bar
will be disabled (no thumb will show and the arrows will be grayed out).
EEEESSSSCCCCAAAAPPPPEEEE SSSSEEEEQQQQUUUUEEEENNNNCCCCEEEESSSS
_x_w_s_h emulates a terminal that supports a subset of ANSI X3.64-1979 (an
"ansi" terminal). xwsh also has features appropriate to a windowing
application. Escape sequences are special characters interpreted by the
terminal (or terminal emulator; i.e. xwsh) to perform functions beyond
simply placing a character on the display. The information that follows
describes all the escape sequences that xwsh understands. A standard set
of conventions are used to describe each escape sequence. For example:
PPPPaaaaggggeeee 11111111
XXXXWWWWSSSSHHHH((((1111GGGG)))) XXXXWWWWSSSSHHHH((((1111GGGG))))
CCCCSSSSIIII PPPPvvvv mmmm
describes a sequence that begins with CSI ("control sequence introducer")
followed by zero or more semicolon separated numbers followed by the
character "m". ESC ("escape") expands to "\033". CSI expands to either
"ESC [" (escape left-bracket) or to "\233". DCS ("device control
string") expands to either "ESC P" (escape capital-P) or to "\220". ST
("string terminator") expands to either "ESC \\" (escape backslash) or to
"\234".
AAAANNNNSSSSIIII EEEESSSSCCCCAAAAPPPPEEEE SSSSEEEEQQQQUUUUEEEENNNNCCCCEEEESSSS
ooooccccttttaaaallll 7777 Ring the bell. See the xwsh set mode below for what this
actually does.
ooooccccttttaaaallll 11110000 Move the cursor left one character. Does not wrap at the
left margin.
ooooccccttttaaaallll 11111111 Move the cursor to the next tab position. Tabs are settable.
ooooccccttttaaaallll 11113333 Move the cursor down one position. Scroll the display if
needed.
ooooccccttttaaaallll 11114444 Move the cursor down one position. Scroll the display if
needed.
ooooccccttttaaaallll 11115555 Move the cursor to the left margin.
EEEESSSSCCCC DDDD oooorrrr ooooccccttttaaaallll 222200004444
Move the cursor down one position. Scroll the display if
needed.
EEEESSSSCCCC EEEE oooorrrr ooooccccttttaaaallll 222200005555
Move the cursor to the start of the next line. Scroll the
display if needed.
EEEESSSSCCCC HHHH oooorrrr ooooccccttttaaaallll 222211110000
Horizontal tab set. Set a tab at the current cursor column.
EEEESSSSCCCC MMMM oooorrrr ooooccccttttaaaallll 222211115555
Move the cursor up one position. Scroll the display if
needed.
EEEESSSSCCCC cccc Reset to initial state.
CCCCSSSSIIII PPPPvvvv AAAA Move the cursor up. The amount to move is taken from the
first parameter, or defaults to one. The display will not be
scrolled.
CCCCSSSSIIII PPPPvvvv BBBB Move the cursor down. The amount to move is taken from the
first parameter, or defaults to one. The display will not be
scrolled.
PPPPaaaaggggeeee 11112222
XXXXWWWWSSSSHHHH((((1111GGGG)))) XXXXWWWWSSSSHHHH((((1111GGGG))))
CCCCSSSSIIII PPPPvvvv CCCC Move the cursor right. The amount to move is taken from the
first parameter, or defaults to one. The cursor will not
wrap at the right margin.
CCCCSSSSIIII PPPPvvvv DDDD Move the cursor left. The amount to move is taken from the
first parameter, or defaults to one. The cursor will not
wrap at the left margin.
CCCCSSSSIIII PPPPvvvv HHHH oooorrrr CCCCSSSSIIII PPPPvvvv ffff
Move the cursor to absolute coordinates specified by the
first and second parameters. The default values for the
parameters are one.
CCCCSSSSIIII PPPPvvvv gggg Clear tabs. If the first parameter has the value 0, then the
tab at the current column is removed. If the first parameter
has the value 3 then all tab stops are cleared. Otherwise,
if the first parameter has a value of 100 then tab stops are
reset to the default state (one every 8 columns).
CCCCSSSSIIII PPPPvvvv LLLL Insert lines. The amount to insert is taken from the first
parameter, or defaults to one. Lines below the cursor
position are moved down. Blank lines with default display
attributes are added at the cursor position.
CCCCSSSSIIII PPPPvvvv MMMM Delete lines. The amount to delete is taken from the first
parameter, or defaults to one. Lines below the cursor
position are moved up, with lines at the bottom being
replaced with blank lines. The blank lines have default
display attributes.
CCCCSSSSIIII PPPPvvvv @@@@ Insert characters. The amount to insert is taken from the
first parameter, or defaults to one. Blank characters with
default display attributes are inserted at the cursor
position.
CCCCSSSSIIII PPPPvvvv PPPP Delete characters. The amount to delete is taken from the
first parameter, or defaults to one. Characters at the
cursor position are deleted.
CCCCSSSSIIII PPPPvvvv XXXX Erase characters. The amount to erase is taken from the
first parameter, or defaults to one. Characters at the
cursor position are erased.
CCCCSSSSIIII PPPPvvvv KKKK Erase in line. If the first parameter is zero then the line
is erased from the cursor position to the end of the line.
If the first parameter is one then the line is erased from
the start of the line up to and including the cursor
position. If the first parameter is two the line is
completely erased.
PPPPaaaaggggeeee 11113333
XXXXWWWWSSSSHHHH((((1111GGGG)))) XXXXWWWWSSSSHHHH((((1111GGGG))))
CCCCSSSSIIII PPPPvvvv JJJJ Erase in display. If the first parameter is zero then lines
are erased from the cursor position to the end of the
display. If the first parameter is one then lines are erased
from the start of the display up to and including the cursor
position. If the first parameter is two the entire display
is erased.
CCCCSSSSIIII PPPPvvvv mmmm Set graphics rendition. Each parameter is examined in turn
and applied to the current graphics rendition. The following
table defines what each of the legal values for the
parameters are.
0000 Reset to default.
1111 Enable bold. Disable half intensity.
2222 Enable half intensity. Disable bold.
3333 Enable italics.
4444 Enable underlining.
7777 Enable reverse video.
22221111 Disable bold (VT100).
22222222 Disable half intensity (VT100).
22223333 Disable italics (VT100).
22224444 Disable underlining (VT100).
22227777 Disable reverse video (VT100).
33330000----33337777 Set the text color to black, red, green, yellow, blue,
magenta, cyan or white, respectively (ISO 6429).
44440000----44447777 Set the page color to black, red, green, yellow, blue,
magenta, cyan or white, respectively (ISO 6429).
CCCCSSSSIIII PPPPvvvv hhhh Ansi set mode. Each parameter is examined in turn and
applied to the current state of xwsh. The following table
defines what each of the legal values for the parameters
are.
2222 Keyboard lock. When set, no keyboard input is allowed. When
reset, the keyboard behaves as normal.
4444 Insert/replace mode. When set, characters are inserted into
the display. When reset, characters overwrite display
characters (this is the normal mode).
PPPPaaaaggggeeee 11114444
XXXXWWWWSSSSHHHH((((1111GGGG)))) XXXXWWWWSSSSHHHH((((1111GGGG))))
22220000 Line feed/new line mode. When set, the new line (octal 12)
character moves the cursor down one line and to the left
margin (scrolling as needed). When reset, the new line
character only performs a downward motion (this is the normal
mode).
CCCCSSSSIIII PPPPvvvv llll Ansi reset mode. Same as ansi set mode, except the modes
are disabled instead of enabled.
CCCCSSSSIIII PPPPvvvv RRRR Cursor position report. This sequence is ignored. The
sequence is usually a result of a request cursor position
escape sequence.
CCCCSSSSIIII PPPPvvvv cccc Ansi device attributes request. If xwsh is run with the
VT100 option enabled, then xwsh will answer this escape
sequence by sending "ESC [ ? 1 ; 2 c".
CCCCSSSSIIII ???? PPPPvvvv cccc Ansi device attributes report. This sequence is ignored.
The sequence is usually a result of an ansi device
attributes request.
CCCCSSSSIIII PPPPvvvv nnnn Device status report. Legal values for the parameter are:
5555 Send null DSR response CCCCSSSSIIII 0000 nnnn.
6666 Report the current cursor position. A CCCCSSSSIIII rrrroooowwww ;;;; ccccoooollll RRRR escape
sequence will be sent by xwsh.
111100000000----111100007777
Report the rgb value (#rrggbb) for a given color using a DDDDCCCCSSSS
PPPPnnnn ....yyyy PPPPssss SSSSTTTT escape sequence (see DCS below for the values that
xwsh will use for Pn). DSR parameter 100 maps to the text
color, 101 to the page color, 102 the selection text color,
103 to the selection page color, 104 to the cursor text color,
105 to the cursor page color, 106 to the half intensity color
and 107 to the bold color.
XXXXWWWWSSSSHHHH EEEESSSSCCCCAAAAPPPPEEEE SSSSEEEEQQQQUUUUEEEENNNNCCCCEEEESSSS
CCCCSSSSIIII ==== PPPPvvvv hhhh xwsh set mode. Each parameter is examined in turn and
applied to the current state of xwsh. The following table
defines what each of the legal values for the parameters are.
6666 Lock display. When set, this mode causes xwsh to keep its
display set to the current location in the retain buffer. Any
scrolling activities, line insert/deletes will not affect the
retain buffer that is outside of the display. When reset,
scrolling off the bottom will move the display to track the
bottom of the retain buffer. When the lock is set, the scroll
bar is disabled, as well as any extend selection mechanisms
that might cause a scroll. The normal mode is in the reset
state, but the standard terminfo for iris-ansi causes visual
programs to lock the display.
PPPPaaaaggggeeee 11115555
XXXXWWWWSSSSHHHH((((1111GGGG)))) XXXXWWWWSSSSHHHH((((1111GGGG))))
9999 Enable visual bell. When set, xwsh will flash the display when
it receives an octal 7 instead of ringing the bell. When reset
it asks X to ring the bell.
11112222 Overlay mode. When set, xwsh moves its display into the
overlay planes. When reset, xwsh displays in the default
visual. This is no longer functional as of IRIX 4.0. The
escape sequence is now ignored.
CCCCSSSSIIII ==== PPPPvvvv llll xwsh reset mode. Same as xwsh set mode, except the modes
are disabled instead of enabled.
CCCCSSSSIIII PPPPvvvv //// yyyy xwsh command. The first parameter to this escape sequence
is the particular command described in the table that
follows. Each command has different numbers of arguments
which are described below.
2222 Textport init. Reset xwsh to be 40 rows by 80 columns. Reset
the colors to the default colors. Reset any graphics
rendition. Clear out the retain buffer. Home the cursor.
11114444 History init. Clear out the retain buffer. Home the cursor.
3333 Push the window. Depending on the window manager, this may or
may not have any affect.
4444 Pop the window. Depending on the window manager, this may or
may not have any affect.
11116666 Reset bindable function keys.
11115555 Initialize bindable function keys to defaults.
111100001111 Set the text color by using a 3.3 compatible index.
111100002222 Set the page color by using a 3.3 compatible index.
111100003333 Set the bold color by using a 3.3 compatible index.
111100004444 Set the cursor page color by using a 3.3 compatible index.
111111111111 Set the selection colors by using 3.3 compatible indices.
This sequence takes three parameters. The first is 111. The
second parameter is the selection text color, the third is the
selection page color.
222200003333 Set the window size by row and column. This sequence takes
three parameters. The first is 203. The second parameter is
the number of rows to use. The third parameter is the number
of columns to use.
PPPPaaaaggggeeee 11116666
XXXXWWWWSSSSHHHH((((1111GGGG)))) XXXXWWWWSSSSHHHH((((1111GGGG))))
222200004444 Set the window size, in pixels. This sequence takes three
parameters. The first is 204. The second parameter is the
new width. The third parameter is the new height. The width
and height are rounded up to the nearest font boundaries.
222200005555 Set the window position, in pixels. The lower left corner of
the display is specified as 0,0.
DDDDCCCCSSSS PPPPnnnn ....yyyy PPPPssss SSSSTTTT
Device control string. Ps is a single ansi string (character codes in
the range of octal 040 to 0176 inclusive). The following defines what
the string is used for.
1111 Set the window title.
3333 Set the icon title.
4444 Set the text color by string. See the -C command for a
description of how the string will be interpreted.
5555 Set the page color by string.
6666 Set the selection text color by string.
7777 Set the selection page color by string.
8888 Set the cursor text color by string.
9999 Set the cursor page color by string.
11110000 Set the half intensity color by string.
11111111 Set the bold intensity color by string.
111100001111 Bind the string to the key named by Pn+1. The key numbers are
the same as the numbers defined in <device.h>. The string can
contain C style backslashed characters to get control
characters into the string. When the key is pressed the value
will be sent to the process that xwsh is managing. This
capability is turned off by default for security. Turn it on
with the "-bindkey2dcs" command line option or with the
"bindKey2DCS" resource.
111100003333 Bind the string to the key named by Pn+1. The key numbers are
the same as the numbers defined in <device.h>. When the key
is pressed the value will be used to invoke a function
internal to xwsh. This capability is turned off by default
for security. Turn it on with the "-bindkey2dcs" command line
option or with the "bindKey2DCS" resource.
PPPPaaaaggggeeee 11117777
XXXXWWWWSSSSHHHH((((1111GGGG)))) XXXXWWWWSSSSHHHH((((1111GGGG))))
VVVVTTTT111100000000 EEEESSSSCCCCAAAAPPPPEEEE SSSSEEEEQQQQUUUUEEEENNNNCCCCEEEESSSS
EEEESSSSCCCC NNNN oooorrrr ooooccccttttaaaallll 222211116666
Single shift G2. The next character is taken literally and
is displayed using the character set in G2.
EEEESSSSCCCC OOOO oooorrrr ooooccccttttaaaallll 222211117777
Single shift G3. The next character is taken literally and
is displayed using the character set in G3.
CCCCSSSSIIII ???? PPPPvvvv nnnn VT100 device status report.
CCCCSSSSIIII ???? PPPPvvvv hhhh VT100 set mode. Each parameter is examined in turn and
applied to the current state of xwsh. The following table
defines what each of the legal values for the parameters are.
1111 VT100 application cursor key mode. When set, the cursor keys
send application escape sequences. When reset, the cursor keys
send the cursor motion escape sequences.
3333 VT100 column mode. When set, the display changes to 132
columns wide. When reset, the display changes to 80 columns
wide. These changes are independent of any size constraints
placed on xwsh.
5555 VT100 screen mode. When set, the colors used to display text
are reversed with their page counterparts. The text and page
colors are exchanged. The selection text and selection page
colors are exchanged. When reset, the exchange is done again
reversing things to their original state.
6666 VT100 origin mode. When set, cursor positions are taken
relative to the scroll region. When reset, cursor positions
are absolute.
7777 VT100 auto wrap mode. When set, auto wrapping occurs normally.
When reset, the cursor will not auto wrap at the right margin.
22225555 VT100 text cursor enable. When set, the text cursor is
displayed. When reset, the text cursor is not displayed.
CCCCSSSSIIII ???? PPPPvvvv llll VT100 reset mode. Same as VT100 set mode, except the modes
are disabled instead of enabled.
EEEESSSSCCCC ==== Put the key pad into application mode.
EEEESSSSCCCC >>>> Put the key pad into numeric mode.
EEEESSSSCCCC ZZZZ VT100 identification. xwsh returns an escape sequence that
describes the configuration of its terminal emulator.
PPPPaaaaggggeeee 11118888
XXXXWWWWSSSSHHHH((((1111GGGG)))) XXXXWWWWSSSSHHHH((((1111GGGG))))
EEEESSSSCCCC 7777 VT100 save cursor. The cursor position, graphics rendition,
character set, and auto wrap state are saved.
EEEESSSSCCCC 8888 VT100 restore cursor. This reverses the save cursor
command.
CCCCSSSSIIII PPPPvvvv rrrr VT100 scroll region. Define the top and bottom margins for
scrolling.
EEEESSSSCCCC (((( BBBB Install ascii character set into G0.
EEEESSSSCCCC (((( 0000 Install graphics character set into G0.
EEEESSSSCCCC )))) BBBB Install ascii character set into G1.
EEEESSSSCCCC )))) 0000 Install graphics character set into G1.
EEEESSSSCCCC **** BBBB Install ascii character set into G2.
EEEESSSSCCCC **** 0000 Install graphics character set into G2.
EEEESSSSCCCC ++++ BBBB Install ascii character set into G3.
EEEESSSSCCCC ++++ 0000 Install graphics character set into G3.
ooooccccttttaaaallll 11117777 Make G0 the current character set.
ooooccccttttaaaallll 11116666 Make G1 the current character set.
EEEESSSSCCCC nnnn Make G2 the current character set.
EEEESSSSCCCC oooo Make G3 the current character set.
EEEESSSSCCCC <<<< VT52 enter ansi mode.
DDDDCCCCSSSS PPPPvvvv |||| PPPPssss SSSSTTTT
VT100 device control string.
EEEESSSSCCCC #### 8888 VT100 screen alignment. Fills the display with upper case
E's.
CCCCSSSSIIII PPPPvvvv xxxx VT100 request terminal parameters.
CCCCSSSSIIII PPPPvvvv qqqq VT100 set/clear led.
XXXXTTTTEEEERRRRMMMM EEEESSSSCCCCAAAAPPPPEEEE SSSSEEEEQQQQUUUUEEEENNNNCCCCEEEESSSS
EEEESSSSCCCC ]]]] PPPPnnnn ;;;; PPPPssss ooooccccttttaaaallll 7777
XTERM set title. If the first parameter is one then Ps is
used as the new icon title. If the first parameter is two
then Ps is used as the new window title.
PPPPaaaaggggeeee 11119999
XXXXWWWWSSSSHHHH((((1111GGGG)))) XXXXWWWWSSSSHHHH((((1111GGGG))))
XXXXWWWWSSSSHHHH BBBBOOOOOOOOLLLLEEEEAAAANNNN RRRREEEESSSSOOOOUUUURRRRCCCCEEEESSSS
xwsh supports the following boolean resources.
aaaalllllllloooowwwwSSSSeeeennnnddddEEEEvvvveeeennnnttttssss [[[[ccccllllaaaassssssss AAAAlllllllloooowwwwSSSSeeeennnnddddEEEEvvvveeeennnnttttssss]]]]
When set this flag allows xwsh to accept keyboard events that have
the send_event flag TRUE. This allows another program to type for
the user.
aaaauuuuttttooooFFFFoooorrrrkkkk [[[[ccccllllaaaassssssss AAAAuuuuttttooooFFFFoooorrrrkkkk]]]]
A flag which specifies if xwsh should automatically fork into the
background during startup.
bbbbiiiinnnnddddKKKKeeeeyyyy2222DDDDCCCCSSSS [[[[ccccllllaaaassssssss BBBBiiiinnnnddddKKKKeeeeyyyy2222DDDDCCCCSSSS]]]]
A flag which enables the binding of keys to device control strings
(DCS). This capability is disabled by default for security reasons.
ccccoooonnnnssssoooolllleeee [[[[ccccllllaaaassssssss CCCCoooonnnnssssoooolllleeee]]]]
This resource when set performs the same function as the -console
command line option.
eeeerrrrrrrroooorrrrEEEExxxxiiiittttHHHHoooollllddddiiiinnnngggg [[[[ccccllllaaaassssssss EEEErrrrrrrroooorrrrEEEExxxxiiiittttHHHHoooollllddddiiiinnnngggg]]]]
When enabled xwsh will maintain its window after the child exits if
the child returns an exit status showing an error condition. This
is a milder form of the holding resource.
ffffiiiixxxxeeeeddddSSSSiiiizzzzeeee [[[[ccccllllaaaassssssss FFFFiiiixxxxeeeeddddSSSSiiiizzzzeeee]]]]
When set xwsh behaves as a fixed size terminal. Its initial maximum
size determines the tty emulation area managed. When the window
changes size the underlying tty emulation area is not affected.
hhhhiiiigggghhhhlllliiiigggghhhhttttUUUURRRRLLLL [[[[ccccllllaaaassssssss HHHHiiiigggghhhhlllliiiigggghhhhttttUUUURRRRLLLL]]]]
This boolean controls whether xwsh will highlight URLs that it
detects in the input stream. If set to True, then if a URL is
detected in the output stream, it is highlighted in Bold Italic. By
default this resource is set to False.
hhhhoooollllddddiiiinnnngggg [[[[ccccllllaaaassssssss HHHHoooollllddddiiiinnnngggg]]]]
This boolean controls what xwsh does when the child program exits.
When set xwsh maintains its window until removed by the window
manager. When reset, xwsh exits when its child exits.
iiiinnnnvvvveeeerrrrttttYYYY [[[[ccccllllaaaassssssss IIIInnnnvvvveeeerrrrttttYYYY]]]]
When set xwsh will y invert the geometry origin coordinates. This
is a compatibility resource for the obsolete wsh(1g) command only.
This resource is obsolete and should not be used.
jjjjuuuummmmppppTTTTooooBBBBoooottttttttoooommmm [[[[ccccllllaaaassssssss JJJJuuuummmmppppTTTTooooBBBBoooottttttttoooommmm]]]]
When set this flag tells xwsh to jump to the bottom of the scroll
display upon any data generating key stroke. When false, xwsh only
jumps when a data scroll occurs (i.e., a newline or equivalent is
output).
PPPPaaaaggggeeee 22220000
XXXXWWWWSSSSHHHH((((1111GGGG)))) XXXXWWWWSSSSHHHH((((1111GGGG))))
kkkkeeeeeeeeppppOOOOnnnnSSSSccccrrrreeeeeeeennnn [[[[ccccllllaaaassssssss KKKKeeeeeeeeppppOOOOnnnnSSSSccccrrrreeeeeeeennnn]]]]
When enabled this flag causes xwsh to attempt to keep its window on
the screen. This flag only takes affect when xwsh is resized from
its own popup menu or from an escape sequence.
kkkkeeeeyyyyMMMMaaaappppFFFFiiiilllleeeeAAAAfffftttteeeerrrr [[[[ccccllllaaaassssssss KKKKeeeeyyyyMMMMaaaappppFFFFiiiilllleeeeAAAAfffftttteeeerrrr]]]]
This boolean determines the order in which the key map file is
applied to the keyboard state. The default value of false means
that the users key map file is applied before any resources. A
value of TRUE means that the users key map file is applied after any
resources.
nnnnooooKKKKeeeeyyyybbbbooooaaaarrrrdddd [[[[ccccllllaaaassssssss NNNNooooKKKKeeeeyyyybbbbooooaaaarrrrdddd]]]]
When set this resource disables the keyboard. No keyboard input
will be allowed.
nnnnooooMMMMeeeennnnuuuu [[[[ccccllllaaaassssssss NNNNooooMMMMeeeennnnuuuu]]]]
When enabled xwsh will not have a popup menu. Same as the -nomenu
command line option.
nnnnooooQQQQuuuuiiiicccckkkkSSSSeeeennnndddd [[[[ccccllllaaaassssssss NNNNooooQQQQuuuuiiiicccckkkkSSSSeeeennnndddd]]]]
When enabled xwsh will not send the primary selection when the
middle pointer is clicked.
oooovvvveeeerrrrFFFFiiiirrrrsssstttt [[[[ccccllllaaaassssssss OOOOvvvveeeerrrrFFFFiiiirrrrsssstttt]]]]
This determines what menu item is under the pointer when the menu
button is pressed. The default value is false and means that
pointer will be over the title. When true the pointer will be over
the first item in the menu.
oooovvvveeeerrrrrrrriiiiddddeeeeRRRReeeeddddiiiirrrreeeecccctttt [[[[ccccllllaaaassssssss OOOOvvvveeeerrrrrrrriiiiddddeeeeRRRReeeeddddiiiirrrreeeecccctttt]]]]
When set xwsh will create an override redirect window. This flag
overrides the noBorder flag.
uuuusssseeeeSSSSccccrrrroooollllllllBBBBaaaarrrr [[[[ccccllllaaaassssssss UUUUsssseeeeSSSSccccrrrroooollllllllBBBBaaaarrrr]]]]
When enabled and the retain limit is greater than the emulation area
xwsh will display a scroll bar. When disabled xwsh will not display
a scroll bar.
vvvviiiissssuuuuaaaallllBBBBeeeellllllll [[[[ccccllllaaaassssssss VVVViiiissssuuuuaaaallllBBBBeeeellllllll]]]]
This flag when set tells xwsh to flash the display in an irritating
manner instead of ringing the annoying bell.
vvvvtttt111100000000 [[[[ccccllllaaaassssssss VVVVtttt111100000000]]]]
If set then xwsh behaves very much like a vt100.
vvvvtttt111100000000WWWWrrrraaaapppp [[[[ccccllllaaaassssssss VVVVtttt111100000000WWWWrrrraaaapppp]]]]
When set this flag tells xwsh to perform right margin wrapping like
it does when in vt100 mode. The TERM variable will also be set to
iris-ansi-nowrap to facilitate correct editing.
PPPPaaaaggggeeee 22221111
XXXXWWWWSSSSHHHH((((1111GGGG)))) XXXXWWWWSSSSHHHH((((1111GGGG))))
XXXXWWWWSSSSHHHH IIIINNNNTTTTEEEEGGGGEEEERRRR RRRREEEESSSSOOOOUUUURRRRCCCCEEEESSSS
xwsh supports the following integer resources.
bbbbaaaarrrrWWWWiiiiddddtttthhhh [[[[ccccllllaaaassssssss SSSSccccrrrroooollllllllBBBBaaaarrrrWWWWiiiiddddtttthhhh]]]]
Define the width of the scroll bar.
mmmmeeeettttaaaaKKKKeeeeyyyyMMMMaaaasssskkkk [[[[ccccllllaaaassssssss MMMMeeeettttaaaaKKKKeeeeyyyyMMMMaaaasssskkkk]]]]
This mask is matched against the XKeyEvent.state to determine if
xwsh should set the high bit in the byte for single character key
strings. The default value is 0.
ppppiiiicccckkkkiiiinnnnggggIIIInnnnsssseeeetttt [[[[ccccllllaaaassssssss PPPPiiiicccckkkkiiiinnnnggggIIIInnnnsssseeeetttt]]]]
This value is used as the width of the gap between the scroll bar
(if any) and the tty region of xwsh.
rrrreeeettttaaaaiiiinnnnLLLLiiiimmmmiiiitttt [[[[ccccllllaaaassssssss RRRReeeettttaaaaiiiinnnnLLLLiiiimmmmiiiitttt]]]]
This integer value defines the number of lines of data to retain.
See the -sl option for more information.
uuuunnnnddddeeeerrrrlllliiiinnnneeeeOOOOffffffffsssseeeetttt [[[[ccccllllaaaassssssss UUUUnnnnddddeeeerrrrlllliiiinnnneeeeOOOOffffffffsssseeeetttt]]]]
Define the number of pixels below the baseline that xwsh will draw
the underline. This value will be limited against the fonts maximum
descender.
XXXXWWWWSSSSHHHH SSSSTTTTRRRRIIIINNNNGGGG RRRREEEESSSSOOOOUUUURRRRCCCCEEEESSSS
xwsh supports the following string resources.
aaaannnncccchhhhoooorrrrPPPPooooiiiinnnntttt [[[[ccccllllaaaassssssss AAAAnnnncccchhhhoooorrrrPPPPooooiiiinnnntttt]]]]
Define the anchor point that xwsh uses when resizing itself from an
escape sequence or its own size menu. See the -anchor option for
more information.
bbbbaaaacccckkkkggggrrrroooouuuunnnndddd [[[[ccccllllaaaassssssss BBBBaaaacccckkkkggggrrrroooouuuunnnndddd]]]]
Define the background color for xwsh.
bbbbaaaarrrrPPPPooooiiiinnnntttteeeerrrrCCCCoooolllloooorrrrBBBBaaaacccckkkkggggrrrroooouuuunnnndddd [[[[ccccllllaaaassssssss BBBBaaaacccckkkkggggrrrroooouuuunnnndddd]]]]
Define the background color of the pointer when its over the scroll
bar.
bbbbaaaarrrrPPPPooooiiiinnnntttteeeerrrrCCCCoooolllloooorrrrFFFFoooorrrreeeeggggrrrroooouuuunnnndddd [[[[ccccllllaaaassssssss FFFFoooorrrreeeeggggrrrroooouuuunnnndddd]]]]
Define the foreground color of the pointer when its over the scroll
bar.
bbbbaaaarrrrPPPPooooiiiinnnntttteeeerrrrSSSShhhhaaaappppeeee [[[[ccccllllaaaassssssss CCCCuuuurrrrssssoooorrrr]]]]
Define the shape of the cursor to use when the pointer is over the
scroll bar (not the arrows!).
bbbboooollllddddCCCCoooolllloooorrrr [[[[ccccllllaaaassssssss BBBBoooollllddddCCCCoooolllloooorrrr]]]]
Define the bold color for xwsh.
PPPPaaaaggggeeee 22222222
XXXXWWWWSSSSHHHH((((1111GGGG)))) XXXXWWWWSSSSHHHH((((1111GGGG))))
bbbboooollllddddFFFFoooonnnntttt [[[[ccccllllaaaassssssss FFFFoooonnnntttt]]]]
Sets the bold font for xwsh to use.
bbbboooollllddddIIIIttttaaaalllliiiiccccoooonnnntttt [[[[ccccllllaaaassssssss FFFFoooonnnntttt]]]]
Sets the bold italic for xwsh to use.
cccchhhhaaaarrrrCCCCllllaaaassssssss [[[[ccccllllaaaassssssss CCCChhhhaaaarrrrCCCCllllaaaassssssss]]]]
Define changes to the character class table used by double click.
cccckkkkmmmmeeeeKKKKeeeeyyyyMMMMaaaapppp [[[[ccccllllaaaassssssss CCCCkkkkmmmmeeeeKKKKeeeeyyyyMMMMaaaapppp]]]]
This resource defines the key mappings that are applied when the
cursor key mode enable escape sequence is received.
cccckkkkmmmmddddKKKKeeeeyyyyMMMMaaaapppp [[[[ccccllllaaaassssssss CCCCkkkkmmmmddddKKKKeeeeyyyyMMMMaaaapppp]]]]
This resource defines the key mappings that are applied when the
cursor key mode disable escape sequence is received.
ccccuuuurrrrssssoooorrrrPPPPaaaaggggeeeeCCCCoooolllloooorrrr [[[[ccccllllaaaassssssss CCCCuuuurrrrssssoooorrrrBBBBaaaacccckkkkggggrrrroooouuuunnnndddd]]]]
Define the cursor page color for xwsh.
ccccuuuurrrrssssoooorrrrTTTTeeeexxxxttttCCCCoooolllloooorrrr [[[[ccccllllaaaassssssss CCCCuuuurrrrssssoooorrrrFFFFoooorrrreeeeggggrrrroooouuuunnnndddd]]]]
Define the cursor text color for xwsh.
ddddeeeeccccAAAAsssscccciiiiiiiiFFFFoooonnnntttt [[[[ccccllllaaaassssssss DDDDeeeeccccAAAAsssscccciiiiiiiiFFFFoooonnnntttt]]]]
Define the font to use for regular ascii text when xwsh is in vt100
mode.
ddddeeeeccccGGGGrrrraaaapppphhhhiiiiccccssssFFFFoooonnnntttt [[[[ccccllllaaaassssssss DDDDeeeeccccGGGGrrrraaaapppphhhhiiiiccccssssFFFFoooonnnntttt]]]]
Define the font to use for graphics characters when xwsh is in vt100
mode.
ddddiiiissssppppllllaaaayyyy [[[[ccccllllaaaassssssss DDDDiiiissssppppllllaaaayyyy]]]]
This resource is the value of the -display command line options
argument.
ffffiiiilllltttteeeerrrrCCCCmmmmdddd1111 [[[[ccccllllaaaassssssss FFFFiiiilllltttteeeerrrrCCCCmmmmdddd1111]]]]
This is the command that is executed when the corresponding
DoFilter1 action happens. Any %s in the string is replaced with the
currently selected text. The string is passed to a shell (/bin/sh)
and so may contain pipelines, redirection, etc.
ffffiiiilllltttteeeerrrrCCCCmmmmdddd2222 [[[[ccccllllaaaassssssss FFFFiiiilllltttteeeerrrrCCCCmmmmdddd2222]]]]
This is the command that is executed when the corresponding
DoFilter2 action happens. Any %s in the string is replaced with the
currently selected text. The string is passed to a shell (/bin/sh)
and so may contain pipelines, redirection, etc.
ffffiiiilllltttteeeerrrrCCCCmmmmdddd3333 [[[[ccccllllaaaassssssss FFFFiiiilllltttteeeerrrrCCCCmmmmdddd3333]]]]
This is the command that is executed when the corresponding
DoFilter3 action happens. Any %s in the string is replaced with the
currently selected text. The string is passed to a shell (/bin/sh)
and so may contain pipelines, redirection, etc.
PPPPaaaaggggeeee 22223333
XXXXWWWWSSSSHHHH((((1111GGGG)))) XXXXWWWWSSSSHHHH((((1111GGGG))))
ffffoooonnnntttt [[[[ccccllllaaaassssssss FFFFoooonnnntttt]]]]
Sets the primary rendition font for xwsh to use.
ffffoooorrrreeeeggggrrrroooouuuunnnndddd [[[[ccccllllaaaassssssss FFFFoooorrrreeeeggggrrrroooouuuunnnndddd]]]]
Define the foreground color for xwsh.
ggggeeeeoooommmmeeeettttrrrryyyy [[[[ccccllllaaaassssssss GGGGeeeeoooommmmeeeettttrrrryyyy]]]]
This string specifies the columns rows and starting position for
xwsh in standard x form.
hhhhaaaallllffffCCCCoooolllloooorrrr [[[[ccccllllaaaassssssss HHHHaaaallllffffCCCCoooolllloooorrrr]]]]
Define the half intensity color for xwsh.
iiiiccccoooonnnnTTTTiiiittttlllleeee [[[[ccccllllaaaassssssss TTTTiiiittttlllleeee]]]]
Defines the title of the icon window if the window manager provides
icon title decorations.
iiiinnnniiiittttSSSSeeeeqqqquuuueeeennnncccceeee [[[[ccccllllaaaassssssss IIIInnnniiiittttSSSSeeeeqqqquuuueeeennnncccceeee]]]]
This resource provides a string which will be interpreted by xwsh
after all other initialization but before any output from the pty is
received. The string can contain escape sequences.
iiiittttaaaalllliiiiccccFFFFoooonnnntttt [[[[ccccllllaaaassssssss FFFFoooonnnntttt]]]]
Sets the italic font for xwsh to use.
kkkkeeeeyyyybbbbooooaaaarrrrddddTTTTyyyyppppeeee [[[[ccccllllaaaassssssss KKKKeeeeyyyybbbbooooaaaarrrrddddTTTTyyyyppppeeee]]]]
Define the keyboard type for xwsh to emulate. iiiibbbbmmmmrrrrtttt and xxxxlllliiiibbbb are the
only choices.
kkkkeeeeyyyyMMMMaaaappppFFFFiiiilllleeee [[[[ccccllllaaaassssssss KKKKeeeeyyyyMMMMaaaappppFFFFiiiilllleeee]]]]
This resource specifies the name of the key map file.
kkkkeeeeyyyyMMMMaaaappppppppiiiinnnngggg0000 [[[[ccccllllaaaassssssss KKKKeeeeyyyyMMMMaaaappppppppiiiinnnngggg0000]]]]
Define first key mappings. These mappings are applied before any
others unless a key map file is used and keyMapFileAfter is FALSE.
kkkkeeeeyyyyMMMMaaaappppppppiiiinnnngggg1111 [[[[ccccllllaaaassssssss KKKKeeeeyyyyMMMMaaaappppppppiiiinnnngggg1111]]]]
Define second key mappings. These mappings are applied after
keyMapping0.
kkkkeeeeyyyyMMMMaaaappppppppiiiinnnngggg2222 [[[[ccccllllaaaassssssss KKKKeeeeyyyyMMMMaaaappppppppiiiinnnngggg2222]]]]
Define third key mappings. These mappings are applied after
keyMapping1.
kkkkppppaaaammmmKKKKeeeeyyyyMMMMaaaapppp [[[[ccccllllaaaassssssss KKKKppppaaaammmmKKKKeeeeyyyyMMMMaaaapppp]]]]
This resource defines the key mappings that are applied when the
keypad application mode escape sequence is received.
kkkkppppnnnnmmmmKKKKeeeeyyyyMMMMaaaapppp [[[[ccccllllaaaassssssss KKKKppppnnnnmmmmKKKKeeeeyyyyMMMMaaaapppp]]]]
This resource defines the key mappings that are applied when the
keypad normal mode escape sequence is received.
PPPPaaaaggggeeee 22224444
XXXXWWWWSSSSHHHH((((1111GGGG)))) XXXXWWWWSSSSHHHH((((1111GGGG))))
mmmmiiiinnnnSSSSiiiizzzzeeee [[[[ccccllllaaaassssssss SSSSiiiizzzzeeee]]]]
This string specifies the minimum size, subject to xwsh's own
minimum constraints for the xwsh window. The string contains either
two comma separated values which specify the columns and rows, or
"x" separated values which specify the rows and columns.
mmmmaaaaxxxxSSSSiiiizzzzeeee [[[[ccccllllaaaassssssss SSSSiiiizzzzeeee]]]]
This string specifies the maximum size. The contents are parsed the
same as the minSize string.
ppppooooiiiinnnntttteeeerrrrCCCCoooolllloooorrrrBBBBaaaacccckkkkggggrrrroooouuuunnnndddd [[[[ccccllllaaaassssssss BBBBaaaacccckkkkggggrrrroooouuuunnnndddd]]]]
Define the background color of the pointer.
ppppooooiiiinnnntttteeeerrrrCCCCoooolllloooorrrrFFFFoooorrrreeeeggggrrrroooouuuunnnndddd [[[[ccccllllaaaassssssss FFFFoooorrrreeeeggggrrrroooouuuunnnndddd]]]]
Define the foreground color of the pointer.
ppppooooiiiinnnntttteeeerrrrSSSShhhhaaaappppeeee [[[[ccccllllaaaassssssss CCCCuuuurrrrssssoooorrrr]]]]
This string defines the name of a cursor to use for the pointer when
the pointer is over the tty portion of the xwsh window.
sssseeeelllleeeeccccttttiiiioooonnnnPPPPaaaaggggeeeeCCCCoooolllloooorrrr [[[[ccccllllaaaassssssss SSSSeeeelllleeeeccccttttiiiioooonnnnBBBBaaaacccckkkkggggrrrroooouuuunnnndddd]]]]
Define the selection page color for xwsh.
sssseeeelllleeeeccccttttDDDDoooowwwwnnnnMMMMaaaapppp [[[[ccccllllaaaassssssss SSSSeeeelllleeeeccccttttDDDDoooowwwwnnnnMMMMaaaapppp]]]]
The list of mappings that apply when modifier keys are held during a
select (left) button down event.
sssseeeelllleeeeccccttttDDDDrrrraaaaggggMMMMaaaapppp [[[[ccccllllaaaassssssss SSSSeeeelllleeeeccccttttDDDDrrrraaaaggggMMMMaaaapppp]]]]
The list of mappings that apply when modifier keys are held during a
select (left) button drag event (while the button is still down).
sssseeeelllleeeeccccttttUUUUppppMMMMaaaapppp [[[[ccccllllaaaassssssss SSSSeeeelllleeeeccccttttUUUUppppMMMMaaaapppp]]]]
The list of mappings that apply when modifier keys are held during a
select (left) button up (released) event.
sssseeeelllleeeeccccttttiiiioooonnnnTTTTeeeexxxxttttCCCCoooolllloooorrrr [[[[ccccllllaaaassssssss SSSSeeeelllleeeeccccttttiiiioooonnnnFFFFoooorrrreeeeggggrrrroooouuuunnnndddd]]]]
Define the selection text color for xwsh.
ttttrrrraaaannnnssssiiiieeeennnnttttFFFFoooorrrr [[[[ccccllllaaaassssssss TTTTrrrraaaannnnssssiiiieeeennnnttttFFFFoooorrrr]]]]
This resource defines a window that xwsh will become the transient
for. If set to ``root'' then xwsh will become the transient for the
root window.
wwwwiiiinnnnddddoooowwwwTTTTiiiittttlllleeee [[[[ccccllllaaaassssssss TTTTiiiittttlllleeee]]]]
Defines the title of the xwsh window, if the window manager provides
title decorations.
BBBBUUUUGGGGSSSS
If you change the instance-name using the ----nnnnaaaammmmeeee option, you can confuse
xwsh by globally setting the background, foreground, or font. That is,
if you use ----nnnnaaaammmmeeee ffffoooooooo then do not include lines like
PPPPaaaaggggeeee 22225555
XXXXWWWWSSSSHHHH((((1111GGGG)))) XXXXWWWWSSSSHHHH((((1111GGGG))))
ffffoooooooo****bbbbaaaacccckkkkggggrrrroooouuuunnnndddd:::: ggggrrrreeeeeeeennnn
ffffoooooooo****ffffoooorrrreeeeggggrrrroooouuuunnnndddd:::: rrrreeeedddd
ffffoooooooo****ffffoooonnnntttt:::: mmmmyyyyccccuuuussssttttoooommmmffffoooonnnntttt
Instead, use
ffffoooooooo....bbbbaaaacccckkkkggggrrrroooouuuunnnndddd:::: ggggrrrreeeeeeeennnn
ffffoooooooo....ffffoooorrrreeeeggggrrrroooouuuunnnndddd:::: rrrreeeedddd
ffffoooooooo....ffffoooonnnntttt:::: mmmmyyyyccccuuuussssttttoooommmmffffoooonnnntttt
Do not expect the ----hhhhoooolllldddd option to work well with programs like _a_p_a_n_e_l
that background themselves immediately. Processes spawned by the child
program are killed when the child dies.
FFFFIIIILLLLEEEESSSS
/usr/lib/X11/app-defaults/XWsh
$HOME/.wshttymode
SSSSEEEEEEEE AAAALLLLSSSSOOOO
bindkey(1), stty(1)
PPPPaaaaggggeeee 22226666